home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / window10.arc / WINDOW10.DOC < prev    next >
Text File  |  1987-06-03  |  9KB  |  195 lines
  1.                                                          June 01, 1987
  2.  
  3.                       MULTI-LEVEL WINDOWS and Q UTILITIES
  4.                                TURBO-C Version 1.0
  5.  
  6.         PURPOSE:
  7.  
  8.         This utility creates incredibly quick multi-level windows as
  9.         library calls in Turbo-C programs for IBM PC/XT/AT compati-
  10.         bles.  They work on MDA, CGA, and EGA adapters in any column mode
  11.         (40/80/etc.).  This utility uses the quick screen writing utilities,
  12.         also in library form.  Users are encouraged to participate in the free
  13.         Teamware concept with the release of these functions. As of this 
  14.         release all of the functions are available in WINDOW10.LIB. Once the
  15.         library functions are commented they will be released as teamware.
  16.         The Q utilities were transformed from TURBO PASCAL inline to
  17.         external assembly using BORLAND's rules.asi macro assembler header
  18.         file.
  19.  
  20.  
  21.         TEST DRIVE:
  22.  
  23.         Compile and run the tutoring program WTUTOR10.C to get a feeling
  24.         for features and speed. Also QDEMO10.C can be compiled to give the
  25.         user a feel for features of the Q UTILITIES. The library functions
  26.         and demos were compiled with the SMALL model and all ERRROR checking
  27.         on.
  28.  
  29.  
  30.         FILES:
  31.                                                      
  32.         In this version, WINDOW10.ARC contains:
  33.  
  34.            !_read.me!  :  File that insists you get a copy of WINDOW10.ARC.
  35.            wtutor10.c  :  Demo of WINDOW10.LIB which also gives a tutorial
  36.                           of user instructions.
  37.            qdemo10.c   :  Demo of the Q UTILITIES also in WINDOW10.LIB.
  38.            qbench10.c  :  A timing program that shows "screens/second" for
  39.                           the Q utilities.
  40.            wtutor10.exe:  Executable version of windowing demo 
  41.            qdemo10.exe :  Executable version of Q UTILITIES
  42.            qbench10.exe : Executable version of timing program
  43.            qdemo10.prj :  Project file used to build qdemo10.exe
  44.            wtutor10.prj:  Project file used to build wtutor10.exe
  45.            qbench10.prj:  Project file used to build qbench10.exe
  46.            window10.doc:  This document.
  47.            qutil10.doc :  Document on Q UTILITIES
  48.            wind10s.lib:  Library of window functions and Q UTILITIES.
  49.                           WINDOW FUNCTIONS:  (see appendix)
  50.                              wiattr(); creates color attribute on fore/back
  51.                              initwindow(): initilizes window environment
  52.                              makewindow(): makes a window on the screen 
  53.                              titlewindow(): title a window with text
  54.                              removewindow(); removes last window by make
  55.                              scrollwindow(): scrolls a window up or down
  56.                              qinit(): intialize Q utilities, DO not call
  57.                                       if you call initwindow();
  58.                          Q UTILITIES: (see qutil.doc)
  59.            windprot.h  :  Header file with prototypes for all of the
  60.                           functions in window10.lib.
  61.            w1.h        :  Header file with type definitions.
  62.            color.h     :  Header file with color definitions.
  63.  
  64.         IMPROVEMENTS:
  65.  
  66.        extern licurrent. -- Keeps track of the window currently being used.
  67.        If you have more than one window displayed and want to swap the active
  68.        window without removing it, two indexes are then required.
  69.        licurrent can be changed by the user; li should not be changed.
  70.  
  71.  
  72.         TEAMWARE:
  73.  
  74.         With the release of this utility, I hope to introduce the concept
  75.         of Teamware.  These utilities are FREE, so don't worry.  Many pro-
  76.         grammers have done some superior individual efforts and have
  77.         benefited many.  But the problem is just that - they are individual
  78.         efforts that as packages are not compatible with other individual
  79.         efforts.  And many of the programs are released as copyrighted so
  80.         that others cannot use them in certain contexts.  It seems that if
  81.         users have other expertise and discover ways to combine each others
  82.         utilities, the benefits can improve greatly.  This is what these
  83.         utilities have done.
  84.  
  85.         As Teamware, users CAN and are encouraged to:
  86.  
  87.            1. Use the utilities to enhance their programs and applications
  88.               in both private and commercial contexts.
  89.            2. Combine, create, and edit other utilities and re-release them
  90.               as Teamware by permission of the previous author(s)/editor(s).
  91.            3. Enhance shareware programs provided they are applications that
  92.               in no way represent or advertise the power of the utilities
  93.               themselves, but shall credit the use of Teamware.
  94.            4. Ask about questionable use of the utility.
  95.  
  96.         As Teamware, users CANNOT:
  97.  
  98.            1. Distribute the utilities for profit.
  99.            2. Combine, create, and edit other utilities and re-release them
  100.               as Shareware or for any profit as enhanced utilities.
  101.  
  102.  
  103.         ADDITIONAL NOTES:
  104.  
  105.         Actual window routines are to be commented and released at a later
  106.         date by the author.
  107.  
  108. ***     Global variables zoomeffect and shadoweffect can be changed at any
  109.         time to either zoom (explode) the window or put up a shadow. The
  110.         shadow as of this version can either be left or rigt.
  111.  
  112.         WTUTOR10.C covers most of the instructions for use. For instance
  113.         the window functions can work on up to 8 display pages depending
  114.         on your video card.  Turbo-C functions only work on the first
  115.         page, page 0.  This is where Q screen utilities come in.  They will
  116.         work on any page.  Even though the window functions will seem to make
  117.         a Turbo-C window on say page 3, the standard procedures of printf,
  118.         fputf,puts, etc. will not work there.  You must then use Q
  119.         screen utilities for those pages.
  120.  
  121.         There may be later versions of WINDOW1x.LIB, so use the latest one.
  122.  
  123.        Remember that a Turbo-C window cannot have less than 2 rows or
  124.        columns.
  125.  
  126.  
  127.         LIABILITY:
  128.  
  129.         No liabilities are assumed if the user misuses these utilities.
  130.  
  131.  
  132.         CREDITS:
  133.  
  134.         The initial program was developed by Michael Burton in his copy
  135.         of WINDO.INC, ver 2.4.  The program was edited by permission and
  136.         re-released as WINDOW30.ARC (TURBO PASCAL).
  137.  
  138.         Copyright (c) 1986 by James H. LeMay, Michael Burton (TURBO PASCAL)
  139.         Copyright (c) 1987 by Michael G. MLachak (TURBO-C)
  140.  
  141.         These procedures are public domain under the Teamware concept.
  142.         If there are any problems, please let me know.
  143.          --------------------------------------------------------------
  144.                            T U R B O   ----    C
  145.           Michael G. Mlachak, 4318 Stewart Court, East Chicago, IN 46312
  146.             1-(219)-397-8952 (after 6:00 PM CST) CIS: 76327,4210
  147.          --------------------------------------------------------------
  148.                           T U R B O  ---- P A S C A L
  149.           Jim LeMay, 6341 Klamath Rd., Ft. Worth, TX  76116
  150.             1-(817) 732-7150 (after 1730 PST), CIS 76011,217
  151.  
  152.           Michael Burton, 15540 Boot Hill Rd., Hayden Lake, ID 83835
  153.             1-(208)-772-9347 (after 1800 PST)
  154.         ---------------------------------------------------------------
  155.         Special effects concepts were graciously suggested by:
  156.  
  157.           Rick Fothergill, 141 Oak Hill Road, Pittsfield, MA 01201
  158.             Data: 1-(413)-499-7245, CIS 76210,443
  159.             GEnie Mail:  R.FOTHERGILL
  160.  
  161.         APPENDIX:
  162.  
  163.                        Functions and there parameters:
  164.              Refer to <WINDPROT.H> for prototypes and W1.H for type
  165.              defintions.
  166.  
  167.                    wattr,battr,attribute: is any color attribute <=255;
  168.                               wiattr() may be called to create an attribute
  169.                               based on foreground and background.
  170.                    fcolor,bcolor: any color defined in COLOR.H
  171.                    begrow,endrow,row,rows: any legal row 1 -25
  172.                    col,cols: any legal column 1 -80
  173.                    direction : any direction defined in W1.h (DIRTYPE)
  174.                    st : any string of type str80
  175.                    justify : can be (left, center,right) -- for top of window
  176.                                     (bottom) -- for bottom center
  177.                                     (nodir) -- restores bottom line of window
  178.                     btype: can be any border type defined in W1.h (BORDERS).
  179.  
  180.           int wiattr(fcolor,bcolor);
  181.           void initwindow(attribute);
  182.           void makewindow(row,col,rows,cols,wattr,battr,btype);
  183.           void removewindow(void);
  184.           void scrollwindow(int begrow,endrow,direction);
  185.           void titlewindow(justify, st);
  186.  
  187.         REVISIONS:
  188.  
  189.          Version 1.0 (6-1-87)
  190.           .  Initial routines
  191.           .  Released under the teamware concept.
  192.  
  193. 
  194.  
  195.